PATH
Mac OS 8 and 9 Developer Documentation
>
Human Interface Toolbox
>
Icon Services and Utilities
>
Obtaining and Using Icons With Icon Services
GetIconRefOwners
Provides the current reference count for an
IconRef
.
pascal OSErr GetIconRefOwners(
IconRef iconRef,
UInt16*owners);
iconRef
A pointer to a value of typeIconRef whose reference count you wish to obtain.
owners
A pointer to a value of type
UInt16
. On return, this value represents the current reference count.
function result
A result code. See
Icon Services Result Codes
for a description of possible return values.
DISCUSSION
When an
IconRef
's reference count reaches 0, all memory allocated for the
IconRef
is marked as disposable. Any subsequent attempt to use the
IconRef
returns a result code of
-2580
(
invalidIconRefErr).
© 1999 Apple Computer, Inc. – (Last Updated 03 Dec 99)